fix(claude-api): replace 7 dead URLs in live-sources.md and related skill files - #1700
Conversation
Hahaknight
left a comment
Hahaknight
left a comment
There was a problem hiding this comment.
Verified what's verifiable from my location — the academy half checks out, the platform.claude.com half I can't confirm either way (geo-blocked egress), plus two concrete nits:
Verified ✅ — academy-guide/SKILL.md:
https://academy.claude.com/resources→ 404 (dead as reported)https://academy.claude.com/all→ 200 — correct replacement.
Cannot verify from this egress (transparency) platform.claude.com/docs/... URL (old and new) 307-redirects from my network to anthropic.com/app-unavailable-in-region, so both the issue's "4 dead URLs" claim and this PR's replacements look identical from here (region-block page returns 200 after following redirects). Maintainers not geo-blocked should spot-check the four new paths before merging. One signal did get through the block: api/sdks/cli.md answers 308 → docs/en/cli-sdks-libraries/sdks/cli.md — i.e. the platform's own canonical successor for that URL is sdks/cli.md, while this PR substitutes cli-sdks-libraries/cli/quickstart.md. If the intent is "follow where the old URL now points", sdks/cli.md is the redirect target; if quickstart.md is deliberately chosen as a better page for the extraction prompt, that's fine but worth a note in the PR body.
Nits — the replacements corrupted the table cells:
- Row label
Computer Use→ComputerUse(space lost);Anthropic CLI→AnthropicCLI. - Extraction prompt lost all spaces:
"ExtractCLIinstall,authentication,commandstructure,andthebeta:agents..."— these prompts are passed verbatim to WebFetch, so they should stay human-readable; the table alignment also broke. Pricing/Skillsrows similarly lost their column padding.
Suggest re-running the edits without the aggressive whitespace collapse, and confirming the four platform URLs from a non-blocked region.
…kill files Rebuilt from main with URL-only substitutions after review found the previous commit's table-padding script had corrupted whitespace in labels and extraction prompts (ComputerUse, ExtractCLIinstall...). URL targets unchanged; reviewed redirects from a non-blocked region: - /docs/en/pricing.md -> /docs/en/about-claude/pricing.md (200) - computer-use.md -> tool-use/computer-use-tool.md (old URL 307s here, 200) - agents-and-tools/skills.md -> agent-skills/overview.md (old 404, new 200) - api/sdks/cli.md -> cli-sdks-libraries/cli/quickstart.md (old 308 chain lands on cli-sdks-libraries/sdks/cli.md which is itself 404, so the redirect target is dead; quickstart.md chosen deliberately, 200) - academy.claude.com/resources -> /all (404 -> 200) - computer-use/overview -> tool-use/computer-use-tool (404 -> 200) Fixes anthropics#1698. Supersedes anthropics#703 (stale, conflicting, credited there).
8976cae to
a1abfda
Compare
|
Thanks @Hahaknight — excellent review, and you caught a real defect: my table-padding script corrupted whitespace in the labels and extraction prompts. Fixed by rebuilding the diff from Completing the verification you couldn't from your egress (checked just now, 2026-09-01 ~21:40 UTC, non-blocked region, redirects followed):
On your The dead-redirect-target detail also strengthens the original issue (#1698): the registry wasn't just stale, one of its entries now redirects to a second dead page — exactly the failure mode agents hit when they "fetch current docs rather than guess." |
|
Thanks for completing the redirect verification — that table is exactly the evidence our egress couldn't produce (the 404-on-follow for
The dead-redirect-target detail is a good strengthening of #1698 — "the registry entry redirects to a second dead page" is precisely the failure an agent hits when it trusts a stale URL over fetching. Review sign-off from my side: findings resolved, no further changes requested. |
2 participants
Summary
Replaces 7 dead URLs across 3 files in the
claude-apiandacademy-guideskills. All 7 listed URLs hard-404 today (verified across multiple passes, redirects followed, both curl and browser UAs); every replacement is confirmed 200 and already present inplatform.claude.com/llms.txt— the registry simply needs re-syncing with the docs index.Full details, per-line reproduction commands, and per-URL status table: #1698.
Fixes
skills/claude-api/shared/live-sources.md(4 rows):docs/en/pricing.md→ 404docs/en/about-claude/pricing.mddocs/en/agents-and-tools/tool-use/computer-use.md→ 404docs/en/agents-and-tools/tool-use/computer-use-tool.mddocs/en/agents-and-tools/skills.md→ 404docs/en/agents-and-tools/agent-skills/overview.mddocs/en/api/sdks/cli.md→ 308→404docs/en/cli-sdks-libraries/cli/quickstart.mdskills/claude-api/shared/tool-use-concepts.md(L342):agents-and-tools/computer-use/overview→ 404 →agents-and-tools/tool-use/computer-use-toolskills/academy-guide/SKILL.md(L90, L115):academy.claude.com/resources→ 404 →academy.claude.com/all— this one has extra bite: the reference is the skill's designated fallback for when a fetch already failed, so the fallback path failed too.Verification
All 7 dead URLs re-checked 2026-08-31 (404 stable); all 5 replacements re-checked 200 the same day. Table row padding adjusted so 3 of 4 modified rows keep their original character width; no other lines touched (+7/−7 total).
Prior art
Supersedes #703 (@y-yagi, March 2026) — now conflicting and covering 2 of the 4 registry rows. Credit to y-yagi for the first two fixes, which this PR includes alongside the remaining rows and the two related files.
Fixes #1698